home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr08 / amw15.zip / AMW.DOC < prev    next >
Text File  |  1995-01-19  |  22KB  |  660 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                            ArcMaster for Windows 1.5
  12.  
  13.                                Copyright 1992..95
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                  Contents
  34.  
  35.  
  36.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  37.           2  Version History . . . . . . . . . . . . . . . . . . . . .  2
  38.           3  What is ArcMaster for Windows (AMW)?  . . . . . . . . . .  3
  39.           4  Programs Needed to Operate AMW  . . . . . . . . . . . . .  3
  40.           5  Installing AMW  . . . . . . . . . . . . . . . . . . . . .  4
  41.              5.1  Step 1.  . . . . . . . . . . . . . . . . . . . . . .  4
  42.              5.2  Step 2.  . . . . . . . . . . . . . . . . . . . . . .  4
  43.              5.3  Step 3.  . . . . . . . . . . . . . . . . . . . . . .  5
  44.              5.4  Step 4.  . . . . . . . . . . . . . . . . . . . . . .  5
  45.           6  About the PIF Files . . . . . . . . . . . . . . . . . . .  5
  46.              6.1  About Testing Archives . . . . . . . . . . . . . . .  5
  47.           7  About Shareware . . . . . . . . . . . . . . . . . . . . .  6
  48.           8  How To Register . . . . . . . . . . . . . . . . . . . . .  6
  49.           9  Distribution Files  . . . . . . . . . . . . . . . . . . .  7
  50.              9.1  On-line Help . . . . . . . . . . . . . . . . . . . .  8
  51.           10  The AMW.INI File . . . . . . . . . . . . . . . . . . . .  8
  52.           11  The NEW-WARE.FON File  . . . . . . . . . . . . . . . . .  9
  53.           12  Running DOS Programs in Minimized Mode . . . . . . . . .  9
  54.           13  About File Managers  . . . . . . . . . . . . . . . . . . 10
  55.           14  About Working Directory Use  . . . . . . . . . . . . . . 10
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                        i
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.   1  Disclaimer
  86.  
  87.  
  88.        New-Ware hereby disclaims all warranties relating to this product,
  89.   whether express or implied, including without limitation any implied
  90.   warranties of merchantability or fitness for a particular purpose. New-Ware
  91.   cannot and will not be liable for any special, incidental, consequential,
  92.   indirect or similar damages due to loss of data or any other reason, even if
  93.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  94.   of such damages.  In no event shall the liability for any damages ever
  95.   exceed the price paid for the license to use software, regardless of the
  96.   form and/or extent of the claim.  The user of this program bears all risk as
  97.   to the quality and performance of the software.
  98.  
  99.  
  100.   2  Version History
  101.  
  102.  
  103.   1.0  -  Initial Release - 10/20/92
  104.   1.1  -  Bug fixes and enhancements (see WHAT'S.NEW) - 10/30/92
  105.   1.2  -  Bug fixes for 1.1 (see WHAT'S.NEW) - 11/30/92
  106.        -  Added Drag & Drop to an Icon Action Window
  107.   1.3  -  The main command option switches were not being properly
  108.           passed to ARJ when compressing.  Fixed.
  109.        -  The conversion function was not properly handling SFX files.
  110.           Fixed.
  111.        -  The Single Arc function was not working for LHA and ARJ.
  112.           Fixed.
  113.        -  The Alt+U key combination was not working.  Fixed.
  114.        -  Problems using the Yank button in the tagged files dialog are
  115.           fixed.
  116.        -  Added support for PKZIP version 2.04c.
  117.   1.4  - The global file tag list is not cleared after moving files to
  118.          an archive if the "Retain Tags" switch is set to ON.
  119.        - AMW was passing the incorrect compression mode switch to PKZIP
  120.          2.04.
  121.        - A Windows GPF might occur when attempting to batch delete files
  122.          that are marked hidden, read-only, system or any combination
  123.          thereof.
  124.        - A Windows GPF might occur if you start AMW with the left window
  125.          set to a directory that has no files and with the right window
  126.          set to a directory that has files.
  127.   1.5  - Fixed a bug that caused problems accessing directory tree items
  128.          256 and greater.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                      - 2 -
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   3  What is ArcMaster for Windows (AMW)?
  144.  
  145.  
  146.        AMW is a Windows (version 3.1 only) program designed to make the
  147.   management of file compression systems and the files they produce much
  148.   easier.  In addition, AMW offers normal file management capabilities such as
  149.   file copy, move, and deletion, directory tree management, and more.
  150.  
  151.  
  152.   4  Programs Needed to Operate AMW
  153.  
  154.  
  155.        You will need at least one of the following archive programs in order
  156.   to utilize the full capabilities of AM.
  157.  
  158.             ARJ from Robert K. Jung  -  ARJ230.XXX
  159.             Robert Jung
  160.             2606 Village Road West
  161.             Norwood, Massachusetts 02062
  162.  
  163.             LHA from Haruyasu Yoshizaki  -  LHA213.XXX
  164.             This program is free.
  165.  
  166.             ZIP from PKWARE  -  PKZ204.C
  167.             PKWARE Inc.
  168.             9025 North Deerwood Drive
  169.             Brown Deer, WI 53223
  170.  
  171.        If you anticipate the need to manipulate files compressed in the
  172.   antiquated ARC format, then it is suggested that you acquire the following
  173.   program:
  174.  
  175.             ARCE from Vernon D. Buerg
  176.             Vernon D. Buerg
  177.             139 White Oak Circle
  178.             Petaluma, CA 94952
  179.  
  180.        The file names following the program identifiers reflect the current
  181.   versions.  Please note the .XXX file extension is given because these will
  182.   vary from location to location.  Many are distributed in compressed
  183.   executable (.EXE) format and some are distributed in the PkWare ZIP format.
  184.   You can find these marvelous programs on just about any computer bulletin
  185.   board system (BBS) or commercial on-line access system such as Compuserve
  186.   Information Service (CIS) or Genie.  All of these programs may be accessed
  187.   from the New-Ware BBS.
  188.  
  189.        While not absolutely essential, the user might have available a full-
  190.   featured file browse utility which AMW can call to view/browse the contents
  191.  
  192.  
  193.  
  194.                                      - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.   of a compressed file existing inside an archive.  The recommended program is
  202.   a state-of-the-art browser from Third Millennium Technologies named LI.  AMW
  203.   can be configured to use any file browser that accepts a file path name on
  204.   its command line.  New-Ware feels that LI is the fastest, most compact, and
  205.   most powerful of the available Windows browsers.  LI can be found on almost
  206.   all BBSs in the form of LIxxx.ZIP (or EXE).  Note that the xxx denotes the
  207.   version and version modifier, as in 122.  Be sure to configure AMW so that
  208.   it can locate LI.EXE.
  209.  
  210.        If you choose not to interface with a separate Windows file browser,
  211.   AMW has an internal bare-bones file browser that will suffice for viewing
  212.   normal and compressed files.  This browser does have a text search utility.
  213.   AMW will use the internal browser if you configure AMW with nothing entered
  214.   in the "Viewer:" field.
  215.  
  216.  
  217.   5  Installing AMW
  218.  
  219.  
  220.        Please note that the supplied PIF files are provided as examples only.
  221.   You MUST edit these files with the Windows 3.1 PIF editor prior to actual
  222.   use.
  223.  
  224.        Installing AMW is very simple.  Just follow these steps:
  225.  
  226.   5.1  Step 1.
  227.  
  228.        Place the following files either in your Windows directory or some
  229.   other directory of your choice:
  230.  
  231.                       AMW.EXE
  232.                       AMW.HLP
  233.                       NEW-WARE.FON
  234.                       ARCE.PIF
  235.                       ARJ.PIF
  236.                       LIST.PIF
  237.                       LHA.PIF
  238.                       PKZIP.PIF
  239.                       PKUNZIP.PIF
  240.                       SCAN.PIF
  241.                       ZIP2EXE.PIF
  242.                       AMWTEST.PIF
  243.  
  244.   5.2  Step 2.
  245.  
  246.        You must place BWCC.DLL and NEW-WARE.FON in your Windows system
  247.   directory or in the directory from which you will execute AMW.  This is
  248.   MANDATORY!
  249.  
  250.  
  251.  
  252.                                      - 4 -
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.   5.3  Step 3.
  260.  
  261.        Run Windows.  Bring up the Program Manager, select the File menu, and
  262.   then select "Run".  If you placed the AMW files above in a directory other
  263.   than your Windows directory, type in the command:
  264.  
  265.                  C:\MYDIR\AMW.EXE INSTALL C:\MYDIR
  266.  
  267.   Where C:\MYDIR is the DOS path name of that directory.  If you placed the
  268.   files in your Windows directories, just type AMW.EXE and press <Enter>.
  269.  
  270.   5.4  Step 4.
  271.  
  272.        When in AMW, select the "mIsc" pull-down menu and then select
  273.   "Configure-AM".  You can get help via the Help button or the F1 key while in
  274.   the configuration dialog.  Configure AMW according to your needs and save
  275.   the configuration.  AMW.CFG will be saved to and maintained in your Windows
  276.   directory.  If you used the INSTALL C:\MYDIR feature in step 3, then be sure
  277.   to enter C:\MYDIR in the AMW Dir: field before saving the configuration.
  278.  
  279.  
  280.   6  About the PIF Files
  281.  
  282.  
  283.        AMW is distributed with a group of PIF files.  Once you have initially
  284.   run and configured AMW, be CERTAIN to use the Windows PIF Editor to modify
  285.   the PIF files for your system.  For example, the enclosed PIF files all have
  286.   C:\UTIL\PROGNAME.EXE in the "Program Filename:" field.  You will have to
  287.   edit this field according to the location of ARJ.EXE, LHA.EXE, PKZIP.EXE,
  288.   etc., etc.  Be ABSOLUTELY CERTAIN that no entry is placed in the "Start-up
  289.   Directory:" field!
  290.   If you desire to start a lengthy archiving operation in AMW and then switch
  291.   to another Windows program, you will need to check the background execution
  292.   box in the PIF editor main window.
  293.  
  294.   6.1  About Testing Archives
  295.  
  296.        The AMWTEST.PIF file is used for testing the integrity of ARJ, LZH, and
  297.   ZIP files.  Note that AMWTEST.PIF points to AMWTEST.BAT.  Also note that
  298.   ARJ.EXE, LHA.EXE, and PKUNZIP.EXE must be in the DOS path in order for the
  299.   batch file to work properly.  Of course, you can easily modify the batch
  300.   file to test the first parameter and then branch to a specific command based
  301.   upon that test, as in if %1==PKUNZIP.EXE goto SOMEPLACE.  This scheme is
  302.   necessary to insure that the testing program is run in a normal window and
  303.   that there is a pause so that you can view the results.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                      - 5 -
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.   7  About Shareware
  318.  
  319.  
  320.        AMW is Shareware.  ARJ, ZIP, and LI are also Shareware.  Shareware is
  321.   NOT free.  It is computer software offered for sale at a set price and the
  322.   only real difference between Shareware and other commercial software
  323.   products is the method of distribution and the important "try before you
  324.   buy" feature.  With Shareware you are normally licensed by the owner/author
  325.   of the program to operate the Shareware distribution copy on a trial basis.
  326.   Then if you like it and make regular use of it, you are bound to pay for it.
  327.  
  328.        AMW is a Shareware product.  As such, it is made available to the
  329.   general computing public for evaluation.  Users are licensed to operate
  330.   ArcMaster on their personal computers for the purpose of test and evaluation
  331.   on a trial basis for a limited trial period.  It is not possible to
  332.   reasonably define any definitive limits of a fair and equitable time period
  333.   for evaluation, therefore it is left to the user's judgment and sense of
  334.   fair play as to the time required to make a decision as to its usefulness.
  335.   If the user decides the program is not of sufficient merit to warrant
  336.   purchase through registration with New-Ware, the program should be removed
  337.   from his or her personal computer.  Otherwise, if the program is deemed
  338.   useful and is in regular use on the user's personal computer system,
  339.   registration with New-Ware is required.
  340.  
  341.        Registered users are those users that elect to pay for AMW and register
  342.   that payment with New-Ware.  By virtue of registration and payment for the
  343.   program, registered users are granted a license to continue to utilize the
  344.   program on their personal computer for as long as they choose.  This license
  345.   authorizes the user to use the program on any personal computer system he or
  346.   she may own so long as the program is operated on only one computer system
  347.   at a time.
  348.  
  349.        Site licenses for use of AMW on multiple computers are available upon
  350.   request at a reduced fee that is based on the number of single machines
  351.   licensed for use.
  352.  
  353.  
  354.   8  How To Register
  355.  
  356.  
  357.        For your convenience, AMW provides a registration dialog in which you
  358.   can quickly fill out and print the registration form.  The dialog can be
  359.   activated from the "About AMW.." System Menu item or the "About AMW..." Help
  360.   Menu item.
  361.  
  362.        The ONLY functional difference between the AMW Shareware distribution
  363.   version and the registered version is that the Shareware version help access
  364.   is via the "About AMW.." dialog.
  365.  
  366.  
  367.  
  368.                                      - 6 -
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.        The price of AMW is $35.00.  Registered users of the DOS version of
  376.   ArcMaster may upgrade to AMW for $10.00.
  377.  
  378.        You may register AMW in one of four ways:
  379.  
  380.             1) By mail with check or money order to:
  381.  
  382.                            New-Ware
  383.                            8050 Camino Kiosco
  384.                            San Diego, CA 92122-1820
  385.  
  386.             2) By telephone with Visa/Mastercard to:
  387.  
  388.                            New-Ware
  389.                            (619) 455-6225
  390.                            8 a.m. to 5 p.m. Pacific Time
  391.                            Monday - Friday
  392.                            8 a.m. to 1 p.m. Pacific Time
  393.                            Saturdays
  394.  
  395.             3) Electronically through the New-Ware BBS:
  396.  
  397.                            New-Ware BBS
  398.                            (619) 455-5226
  399.                            24 Hours per day
  400.                            7 Days per week
  401.  
  402.             4) In Japan please call P. & A. Ltd. at 0435-46-9141
  403.  
  404.        Special site license rates for licensing multiple copies of ArcMaster
  405.   are available.  Please license fee schedule information.
  406.  
  407.        Foreign (non-US/Canada) orders must include a $2.00 special handling
  408.   fee in addition to the $35.00 registration fee.  Also, no checks on banks
  409.   located outside the United States will be accepted.
  410.  
  411.        California residents MUST include state sales tax with their order.
  412.  
  413.        The Shareware version of AMW may be freely copied and passed on to
  414.   other individual users for their evaluation.  Disk vendors and/or
  415.   distributors that desire to distribute ArcMaster must adhere to the
  416.   guidelines presented in VENDOR.DOC.
  417.  
  418.  
  419.   9  Distribution Files
  420.  
  421.  
  422.        The following files are included in the AMW distribution package:
  423.  
  424.  
  425.  
  426.                                      - 7 -
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                  AMW.EXE        - Main program
  434.                  BWCC.DLL       - Dynamic Link Library file
  435.                  AMW.HLP        - Help file
  436.                  NEW-WARE.FON   - Font file
  437.                  AM.DOC         - AMW Documentation
  438.                  xxxx.PIF/BAT   - Various Windows PIF/BAT files
  439.                  WHAT'S.NEW     - Latest product info (if needed)
  440.  
  441.        New-Ware prohibits the modification of any of these files in any way,
  442.   shape, or form except by the individual evaluator or purchaser.
  443.  
  444.   9.1  On-line Help
  445.  
  446.        An extensive Windows 3.1 help file is included with AMW.  Operating
  447.   instructions for each AMW function are contained in this file.  To obtain
  448.   help while running AMW you may press the F1 key from just about anywhere in
  449.   the program, press the help button whenever it is visible, or utilize the
  450.   main pull-down help menu.
  451.  
  452.        AMW help is context sensitive.  For example, you can activate one of
  453.   the pull-down menus, move the cursor to a menu item, and press the F1 key to
  454.   get help specific to that item.  You can also press F1 or the Help button in
  455.   any of the numerous AMW dialog boxes for context sensitive help.  Note that
  456.   all help requests in the Shareware version go through the "About AMW.."
  457.   dialog.
  458.  
  459.  
  460.   10  The AMW.INI File
  461.  
  462.  
  463.        Whenever AMW is executed, it looks for a text file named AMW.INI in
  464.   your Windows directory.  If found, it loads it.  If not found, AMW will
  465.   create one for you.  You may use any text editor to modify this file.
  466.  
  467.        AMW.INI has two sections.  The first section is entitled [masks].  Up
  468.   to 12 DOS file masks may be entered under this section.  An example is:
  469.  
  470.             [masks]
  471.             *.*
  472.             *.ZIP
  473.             *.LHA
  474.             *.WKS
  475.             *.WRI
  476.  
  477.   AMW will use the mask entries in a drop-down list box from which you can
  478.   select a file mask for one of the two file list windows.
  479.  
  480.  
  481.  
  482.  
  483.  
  484.                                      - 8 -
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.        The second section is entitled [progs].  Up to 12 DOS program path
  492.   names and/or Windows PIF files may be entered under this section.  An
  493.   example is:
  494.  
  495.             C:\WINDOWS\CALEND.EXE
  496.             LIST.PIF
  497.             E:\UTIL\NUTHIN\MYPROG.EXE
  498.  
  499.   AMW will use these entries in a drop-down list box from which you can select
  500.   a program to launch.
  501.  
  502.  
  503.   11  The NEW-WARE.FON File
  504.  
  505.  
  506.        The NEW-WARE.FON file is a Windows font that is provided to owners of
  507.   Borland Pascal for Windows.  This font is named BorlandTE  You may elect to
  508.   install this handsome font in your system through the following steps:
  509.  
  510.        1. Run the Control Panel from the Program Manager.
  511.  
  512.        2. Select Fonts from the control panel.
  513.  
  514.        3. Select the Add button.
  515.  
  516.        4. Use the directory/file dialogs to select the directory where
  517.           your copy of NEW-WARE.FON resides.  Select BorlandTE and
  518.           install it.  You might want to check the "Copy to windows
  519.           directory box."
  520.  
  521.        AMW will still load and use the BorlandTE font if don't install the
  522.   font semi-permanently but doing so gives you access to this nice font in
  523.   other areas of Windows.
  524.  
  525.  
  526.   12  Running DOS Programs in Minimized Mode
  527.  
  528.  
  529.        AMW runs ARJ.EXE, LHA.EXE, and PKZIP.EXE as minimized windows programs.
  530.   This is done to reduce the herky-jerky effect of having a DOS window open
  531.   and close briefly.  There are certain circumstances under which any one of
  532.   these programs might issue a prompt and await user keyboard response before
  533.   continuing.  An example is when decompressing files and the decompressor
  534.   needs to know if it's okay to overwrite a file.  You will not see the issued
  535.   prompt because the program is minimized but you will note that he program's
  536.   icon has not been removed and/or that the desired results did not occur.  In
  537.   that case, simply click on the icon to restore the full window and make your
  538.  
  539.  
  540.  
  541.  
  542.                                      - 9 -
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.   response.  It's not the smoothest way to operate, but until the archive
  550.   systems are ported to Windows it is the best that can be done.
  551.  
  552.        Testing the integrity of a compressed file is a special case where you
  553.   will certainly wish to see the test results.  AMWTEST.PIF and AMWTEST.BAT
  554.   are provide to handle this special case.  Note that ARJ.EXE, LHA.EXE,
  555.   PKUNZIP.EXE must be in the DOS path if you use AMWTEST.BAT as configured.
  556.   You can configure the batch file to point to a specific location as in the
  557.   following example:
  558.  
  559.   if %1==PKUNZIP.EXE goto CALLUNZIP
  560.   ...
  561.   ...
  562.   :CALLUNZIP
  563.   D:\MYZIPDIR\PKUNZIP.EXE %2 %3 %4 %5 %6
  564.   ...
  565.  
  566.   The use of this batch file is necessary to insert a pause for the purpose of
  567.   examining the test results.
  568.  
  569.  
  570.   13  About File Managers
  571.  
  572.  
  573.        Not all file managers are equal.  AMW interfaces with the Microsoft
  574.   Windows 3.1 file manager (WINFILE.EXE) for drag & drop operations.  Drag &
  575.   Drop may or may or may not work with other Windows file managers.  You'll
  576.   just have to experiment and see.
  577.  
  578.  
  579.   14  About Working Directory Use
  580.  
  581.  
  582.        AMW requires an exclusive working directory in which to store extracted
  583.   files for viewing, scanning, etc., operations.  ARJ, LHA, and PKZIP also
  584.   require a working directory for certain operations.  You should specify a
  585.   working directory in the AMW configuration dialog.  Be sure that this is an
  586.   empty directory NOT used by any other program because AMW will delete all
  587.   files stored there after certain operations.  Also, be certain that you do
  588.   NOT use the specified work directory as a host of compressed files you
  589.   intend to view or otherwise manipulate.  You may lose those files.  In other
  590.   words, never set the AMW left or or right window to view your work
  591.   directory.
  592.  
  593.        When you first install AMW, it will create a subdirectory in the
  594.   directory that you designated.  For example if you install using  INSTALL
  595.   D:\AMW as parameters, AMW will create D:\AMW\!AMWTMP! as the work directory.
  596.  
  597.  
  598.  
  599.  
  600.                                      - 10 -
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.   You can change this later via the AMW configuration dialog and remove
  608.   !AMWTMP! if so desired.
  609.  
  610.        If you execute AMW and it cannot locate its work directory,
  611.   you will receive a warning.  Be certain to designate a valid work  directory
  612.   via the configuration dialog (Ctrl+C) for exclusive AMW use.
  613.  
  614.   Copyright 1992..95 all rights reserved:
  615.  
  616.   New-Ware
  617.   8050 Camino Kiosco
  618.   San Diego, CA 92122-1820
  619.   (619) 455-6225
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                      - 11 -
  659.  
  660.